Setting up a SNiFF+ project with ClearCase

In this section, you will learn how to set up a SNiFF+ project in your ClearCase View. But before setting up a SNiFF+ project, you will have to prepare your ClearCase environment:

Make sure that all the files for which you want to create the project are already under the control of ClearCase. In order words, the files should already be elements of a VOB.
Make sure that there is a View that accesses the VOB. In the following, it is assumed that you are the owner of this View.
Set your View.

- On Unix -- In a shell, enter the command

cleartool setview your_view.
- On Windows -- The View becomes active as soon as it is mapped to a drive.
On Windows -- The SHELL environment variable must be modified to use forward slashes in the Make Support file. To do so, open the file
%SNIFF_DIR%\make_support\i386-unknown-win32.mk
and edit the line:
SHELL = sh
to read -- using FORWARD slashes:
SHELL = path/to/directory/holding/sh.exe
(By default, sh.exe is in SNIFF_DIR/bin )
Launching the Project Setup Wizard
You're now ready to create the project. You'll do so in the Project Setup Wizard.

Start SNiFF+ if you haven't already done so.
To start the Project Setup Wizard, in the Launch Pad, choose Project > New Project > with Wizard....

In the Project Setup Wizard
The Wizard starts by asking you to select how you intend to use the new SNiFF+ Project.

- Accept the default selection, Standard Setup, and press Next.
The "Select development task" page appears.
In the remaining steps, we will refer to the names of Wizard pages. You can find a page's name in the title bar of the Wizard.

In the "Select development task" page

- Select Create a new SNiFF+ Project from scratch and press Next.

In the "Your development organization" page
This tutorial is for single-user/single platform development using ClearCase as the underlying CMVC tool, so:

Accept the first two defaults (No/No) in the Page.
Select ClearCase as your version control tool.
Press Next.

In the "Select file types" page

- Select the file types that you want to be included in the project and press Next.
Note that, after project setup, you can add new standard file types (like the ones in the "Additional File Types Column"), or create and add your own.

In the "Specify Private Working Environment" page
You are asked to specify your Private Working Environment (PWE) root directory. This directory must be set to the mounting point of the VOB.
For example, suppose you have defined the VOB first_vob. Furthermore, your View, called your_view, accesses first_vob. Then, the mounting point of the VOB is, for example:

- On Unix --

~your_home_dir/first_vob
- On Windows --
F:\first_vob , where F is the drive letter associated with your_view

| Note
| If you intend to change ClearCase Views during a single SNiFF+ session, please read Changing Views in current SNiFF+ session before continuing.

To specify your PWE root directory:

Press Browse, and in the Directory dialog, navigate to the mounting point of the VOB and then press Select.
In the PWE name field, enter a name for the PWE, e.g.,

myClearcaseView .
Notice that your username is entered next to the enabled Owner button. SNiFF+ needs your username to correctly handle permissions. Being the owner of the PWE means that you are the only one who is allowed to modify the working environment's attributes.
Press Next.
In the "Create New SNiFF+ Project" page
SNiFF+ has set your Project root directory to the mounting point of the VOB. The project has the same name as the VOB, with the extension . shared .

If you intend to create the project in another directory, navigate to the Project root directory by pressing the Browse button.
The name of the project is entered in the Project name field with the extension

.shared .
If SNiFF+ should automatically create subprojects in the subdirectories of the Project root directory, make sure that the Create Subprojects is selected.
Press Next.
In the "Project Setup Summary" page
This page summarizes your specifications for the new SNiFF+ project and the PWE.

- Press Finish.

SNiFF+ will now create the new project and all its subprojects. When SNiFF+ is finished, it opens the new project and displays its structure and contents in the Project Editor.